home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1996 July / macformat-039.iso / Internet Essentials / Internet Shareware / MacHTTP 2.2 / MacHTTP Software & Docs / Documentation / Release_Notes.txt < prev    next >
Encoding:
Text File  |  1994-12-18  |  11.8 KB  |  261 lines  |  [TEXT/ttxt]
  1. Release Notes for MacHTTP 2.0
  2. This file (and part 2) summarize all of the changes made to MacHTTP since version
  3. 1.3 was released. It is in reverse chronological order. It's worth reading
  4. through as there may be some tidbits of info here that failed to make it to the
  5. formal documentation.
  6.  
  7. Version 2.0fc4b additions
  8. -----------------------
  9. + Fixed a bug introduced in 2.0fc4 related to handling cached document requests.
  10.  
  11. + added Message-ID: fields to MacHTTP return headers for HTTP/1.0 compliance.
  12.  
  13. + changed Date: header field to be the date/time of the reply and not a file's
  14. creation date, in compliance with HTTP/1.0 spec.
  15.  
  16. + fixed the logging problem with NetScape when connections are dropped too soon
  17. by the client.
  18.  
  19. Version 2.0fc4 additions
  20. ----------------------
  21. +fixed bug with slow client requests and made request processing conform to HTTP
  22. new standard. This fix substantially reduced the memory requirements for handling
  23. POST requests as a side-effect.
  24.  
  25. + zero out DNS cache when the no_dns property is toggled. The DNS cache was also
  26. increased to 20 entries.
  27.  
  28. +changed MacHTTP application class code to 'capp'. This conforms to the
  29. AppleEvent convention.
  30.  
  31. Version 2.0fc3 additions
  32. ----------------------
  33. + corrected problem with status report AppleEvent
  34.  
  35. + created a background-only version of MacHTTP
  36.  
  37. Version 2.0fc2 additions
  38. ----------------------
  39. + added support for %xx encodings in the Mac O/S file type and creator fields in
  40. suffix mappings in the config file. Now you can encode special characters (and
  41. spaces) that might appear in file types and creator codes in the MacHTTP.config
  42. file using the same %xx hex encodings as those used in URLs.
  43.  
  44. + fixed the About box. It's no longer "under construction".
  45.  
  46. + fixed bug with HEAD response for files not found. MacHTTP now returns the
  47. appropriate error response (file not found) if a HEAD request is made for a
  48. non-existent file.
  49.  
  50. + MacHTTP no longer returns modified and creation date info for the "error" file.
  51. This prevents caching of error messages in place of the real file.
  52.  
  53. + file not found error message is now returned correctly. MacHTTP was returning a
  54. 200 OK status code when files weren't found. It now returns the correct file not
  55. found error code, but still returns the contents of (or executes) the ERROR file
  56. specfied in the config file.
  57.  
  58. + The message and status code returned to clients when the server is refusing
  59. connections has been fixed to return the 202 Accepted code to prevent improper
  60. caching of messages from MacHTTP in place of the real document.
  61.  
  62. + referer information is logged to screen for missing file references. When a
  63. request is made for a non-existent file, MacHTTP prints the URL of the document
  64. containing the bad URL on the screen if the WWW client provides this information.
  65.  
  66. + removed text translations for CGI results so they match ACGI behavior. CGI
  67. scripts and apps were still having their return results translated, which messed
  68. up the ability to return binary information. Please let me know if this has an
  69. adverse affect on CGI apps like AppleWebSearch.
  70.  
  71. + added user-agent parameter for scripts and CGIs. All supported scripting
  72. interfaces now receive the "user-agent" parameter if a client supplies it. This
  73. is the name and version of the client being used. For CGI and application
  74. authors, the AppleEvent keyword value for the user-agent parameter is 'Agnt'.
  75.  
  76. Version 2.0fc1 additions
  77. ----------------------
  78. This is a final candidate version of MacHTTP 2.0. This version contains the
  79. complete functionality of version 2.0, and all reported bugs are fixed. If no
  80. problems are found with this version, it will become 2.0 as soon as I fix the
  81. About box. New changes and features for this version include:
  82.  
  83. + added support for the HEAD method. This is identical to GET except that no
  84. content is returned (only the header). Useful for robots, etc.
  85.  
  86. + fixed abrupt connection drops for busy and refused connections. MacHTTP was
  87. dropping the connection too quickly when telling some clients that the server was
  88. busy or refusing connections. MacHTTP now treats busy and refused connections as
  89. regular connections, running them through the state machine. Appropriate HTTP
  90. status codes are returned for BUSY and SERVICE UNAVAILABLE now.
  91.  
  92. + removed the HIDEWINDOW config file command. This function is performed by the
  93. menu option of the same name.
  94.  
  95. + fixed premature connection drop logging problem. When clients terminated a
  96. transfer, MacHTTP wasn't logging the partial data transfer or the file access. It
  97. does now.
  98.  
  99. + added an indicator for refused connections. If "Refuse Connections" is selected
  100. from the Option menu, a red "Refused" message appears in the status display.
  101.  
  102. + added notifcation of memory errors when MacHTTP is in the background. If
  103. MacHTTP is running in the background, or as a background-only app, then it will
  104. use the Notification Manager to alert the user that a problem has cropped up.
  105.  
  106. + MacHTTP now caches the last 10 DNS look-ups.
  107.  
  108. Version 2.0b7 additions
  109. ---------------------
  110. + Added a memory status graph and changed low memory warning. The status graph
  111. shows the amount of free memory remaining (in white). Low memory warning shows up
  112. whenever MacHTTP doesn't have sufficient memory to complete an operation.
  113.  
  114. + Added events for adding and deleting passwords. Add User and Delete User events
  115. allow you to manage passwords for realms from AppleScript. Uses for this might
  116. include allowing users to self-validate themselves after completing a
  117. questionaire, scripts that can add users to a discussion list managed by MacHTTP,
  118. bulk load of usernames from a text file, etc.
  119.  
  120. + MacHTTP now gets a file's modification date from actual target of an alias, not
  121. the alias itself. This makes if-modified-since requests work correctly for all
  122. files and doesn't require that aliases be remade each time the original is
  123. modified.
  124.  
  125. + Reduced max MAXUSERS to 46 to accomodate MacTCP's limit. This leaves 2 spare
  126. connections for other IP applications.
  127.  
  128. + MacHTTP now saves its window location and size as well as the values of flags
  129. in the Options menu in the MacHTTP Settings file. These values are restored the
  130. next time the program starts. If you want to reset the window location and
  131. dimensions to the default values, hold down the mouse button while MacHTTP starts
  132. up.
  133.  
  134. + Added Referer: argument to CGIs. The AppleEvent keyword 'refr' contains the
  135. value of the "Referer:" field from the HTTP header. This is the URL to the
  136. document that referenced the current page. The variable passed to SCRIPT files is
  137. "referer".
  138.  
  139. Version 2.0b6 additions
  140. ---------------------
  141. + Fixed several bugs related to crashes in b5, mostly related to increased POST
  142. arg size.
  143.  
  144. + Modified CGI logic to use System 7 temporary memory calls to help improve
  145. MacHTTP's low memory performance.
  146.  
  147. + Post args are now set at 24K. 32K is too large for many clients and if the full
  148. 32k bytes are used, they are too large for AppleScript to compile SCRIPT files.
  149.  
  150. + Removed the Max Free memory indicator to free up space for new info in the
  151. status area, as it never changed and was of little value.
  152.  
  153. Version 2.0b5 additions
  154. ---------------------
  155. + Added support for 32k POST arguments. Normal GET requests are allowed to be as
  156. large as 4k now, while POST requests can be as large as 32k.
  157.  
  158. + Enhanced low memory behavior. MacHTTP now reserves a small amount memory for
  159. "emergency" situations. If MacHTTP's free memory decreases below a critically low
  160. value, this memory is freed up and all new connections are refused. This allows
  161. the server to continue running, informing clients there is a problem. But,
  162. MacHTTP won't serve any more documents until the administrator intervenes.
  163.  
  164. + Added a low memory error indicator. If any type of low memory situation occurs,
  165. MacHTTP
  166. will draw a big, red "M" in the status area. If you see this indicator, it means
  167. that MacHTTP ran out of memory at some point. If details aren't visible in the
  168. status message area, scroll the buffer backwards and check for more info.
  169.  
  170. Version 2.0b4 additions
  171. ---------------------
  172. + fixed problem related to crashes when client sends empty From: tag. This should
  173.  fix the last of the unexplained crashes.
  174. + modified response behavior for error and noaccess files. MacHTTP now correctly
  175. sends the defined error file whenever a URL cannot be found. The error file can
  176. now be a CGI (SCRIPT, ACGI, etc.) which will be executed when a requested file
  177. cannot be found. The requested URL will be passed to the script, allowing URL
  178. redirection to be done for missing files, etc.
  179.  
  180. Version 2.0b3 additions
  181. ---------------------
  182. + fixed memory leak bug related to the mystery crashes since b13.
  183.  
  184. Version 2.0b2 additions
  185. ---------------------
  186. + fixed HTML error returns for bad script executions. Clients now get a clue that
  187. a script failed to execute correctly.
  188. + removed modal warnings that caused MacHTTP to stop processing requests until OK
  189. was clicked. No more "Unable to create IP stream" modal dialogs.
  190. + fixed start-up bug that crashes the system when MacTCP isn't loaded
  191. successfully.
  192. + fixed range check bugs when setting property/config file values
  193. + added 503 Server too busy error code. Not very much client support for this
  194. yet, so you won't see any benefits with clients like NetScape until they add
  195. support.
  196.  
  197. Version 2.0b1 additions
  198. ---------------------
  199. + Added additional parameters to CGIs and SCRIPTs: from_user, server_name,
  200. server_port, 
  201.   script_name, content_type.  Variables available for use in SCRIPT, CGI, and
  202. ACGI files:
  203. -- http_search_args - stuff in the URL after a ?
  204. -- post_args - stuff in the URL after a $
  205. -- method - GET, POST, etc. Used to tell if post_args and content_type are valid
  206. -- client_address - IP address or domain name of remote client's host
  207. -- from_user - non-standard. e-mail address of remote user
  208. -- username - authenticated user name
  209. -- password - authenticated password
  210.  
  211. The next 3 variables are useful from scripts that want to generate URLs on the
  212. fly that are self-referencing. You should be able to write "portable" scripts
  213. using this information, since you won't need to hard-code your host name, etc.
  214. into scripts anymore.
  215.  
  216. -- server_name - name or IP address of this server
  217. -- server_port - TCP/IP port number being used by this server
  218. -- script_name - URL name of this script
  219.  
  220. This variable is only valid when method = "POST"
  221. -- content_type - MIME content type of post_args
  222.  
  223. + Added AppleEvent support for setting some config file variables remotely. You
  224. can now Get and Set the following MacHTTP application properties from
  225. AppleScript. See the MacHTTP "machttp_admin.acgi" sample script for examples of
  226. their use.
  227.  
  228. Properties:
  229.     dump_buf_size  small integer  -- Output buffer size for TCP/IP writes to
  230. clients. (256-10240)
  231.     pig_delay  small integer  -- Number of ticks to run MacHTTP before
  232. relinquishing control to other apps (0-120)
  233.     maxusers  small integer  -- Maximum number of simultaneous users. (3-1000)
  234.     no_dns  boolean  -- Toggle for domain name resolution by MacHTTP
  235. (true=off/false=on)
  236.     time_out  small integer  -- Timeout value for idle MacHTTP connections and
  237. AppleEvents in seconds (5-600)
  238.     maxlistens  small integer  -- Maximum number of TCP/IP listens to queue up
  239. (3-50)
  240.  
  241. For instance, the following would adjust the "pig_delay" property by 10 and show
  242. the result in the Script Editor's result window:
  243.  
  244. tell application "MacHTTP 2.0b1"
  245.     get pig_delay        --"result" holds the value of pig_delay now
  246.     set pig_delay to (result + 10)
  247.     get pig_delay
  248. end tell
  249.  
  250. Warning! If you access these properties, or any other MacHTTP AppleEvents from a
  251. script called from MacHTTP, it MUST be from an ACGI type script. Any other script
  252. type will cause MacHTTP to deadlock with your script until the AppleEvent times
  253. out.
  254.  
  255. + fixed FREF resource and file type info for settings file. You should rebuild
  256. your desktop to get the new icon for the settings file.
  257.  
  258. NOTE: Version notes for 1.3.1bx versions are contained in the Read Me (2)
  259. document. This document contains important info that should be read if this is
  260. your first 2.0x download.
  261.